---
title: Desi Vocal
description: DesiVocalTools provides text-to-speech capabilities using Indian voices through the Desi Vocal API.
---


## Example

The following agent can convert text to speech using Indian voices:

```python
from agno.agent import Agent
from agno.tools.desi_vocal import DesiVocalTools

agent = Agent(
    instructions=[
        "You are a text-to-speech assistant that converts text to natural Indian voices",
        "Help users generate audio from text using various Indian accents and languages",
        "Provide information about available voices and their characteristics",
        "Create high-quality audio content for users",
    ],
    tools=[DesiVocalTools()],
)

agent.print_response("Convert this text to speech: 'Namaste, welcome to our service'", stream=True)
```

## Toolkit Params

| Parameter              | Type                | Default                                  | Description                                                    |
| ---------------------- | ------------------- | ---------------------------------------- | -------------------------------------------------------------- |
| `api_key`              | `Optional[str]`     | `None`                                   | Desi Vocal API key. Uses DESI_VOCAL_API_KEY if not set.      |
| `voice_id`             | `Optional[str]`     | `"f27d74e5-ea71-4697-be3e-f04bbd80c1a8"` | Default voice ID to use for text-to-speech.                 |
| `enable_get_voices`    | `bool`              | `True`                                   | Enable voice listing functionality.                          |
| `enable_text_to_speech`| `bool`              | `True`                                   | Enable text-to-speech conversion functionality.             |

## Toolkit Functions

| Function         | Description                                                      |
| ---------------- | ---------------------------------------------------------------- |
| `get_voices`     | Retrieve list of available voices with their IDs and details.   |
| `text_to_speech` | Convert text to speech using specified or default voice.        |


## Developer Resources

- View [Tools Source](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/desi_vocal.py)
- [Desi Vocal API Documentation](https://desivocal.com/docs)
- [Indian TTS Best Practices](https://desivocal.com/best-practices)
